home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 2001 May
/
SGI IRIX Base Documentation 2001 May.iso
/
usr
/
relnotes
/
atm
/
ch2.z
/
ch2
Wrap
Text File
|
2001-04-17
|
19KB
|
524 lines
- 1 -
2. _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
This chapter provides information about installing IRIS ATM
software. The information listed here is product-specific;
for general information about installing software, refer to
the _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.
The IRIS ATM product consists of a hardware component and a
software component. The hardware component is an IRIS ATM
board and associated items; the software is on the CD-ROM.
To install the IRIS ATM product, follow the procedures in
the overview below. The procedures must be followed in the
order they are listed.
1. Install the software, using the instructions in this
document in Section 2.2, ``Installing IRIS ATM
Software.''
2. Configure the software, using the instructions in the
_I_R_I_S _A_T_M _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e.
Note: Do not configure IRIS ATM as the primary IP
network interface. IRIS ATM as a primary IP
network connection is not supported in this
release.
3. Have an authorized field service engineer install the
hardware using the field service document, _I_R_I_S _A_T_M
_I_n_s_t_a_l_l_a_t_i_o_n _I_n_s_t_r_u_c_t_i_o_n_s.
4. Verify the ATM connection, using the instructions in
the section ``Verifying the ATM Subsystem,'' in the
_I_R_I_S _A_T_M _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e.
2.1 _G_e_n_e_r_a_l__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
This section contains general information about the IRIS ATM
software. This information is useful during installation
and configuration.
2.1.1 _A_T_M__N_e_t_w_o_r_k__I_n_t_e_r_f_a_c_e__N_a_m_e_s During design, the
logical IP network interface for each controller board that
supports the IP network stack is given a name. The ATM
network interface name is as specified below:
_a_t_m# Unlike many network products that support only one
IP network interface for each physical port, IRIS
ATM can support multiple IP network interfaces on
each port. The exact number of IP interfaces that
- 2 -
are assigned to each IRIS ATM board is
configurable, as described in Chapter 3 of the _I_R_I_S
_A_T_M _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e. There is no default
configuration for IRIS ATM logical network
interfaces. Each interface must be manually
configured.
2.1.2 _I_R_I_S__A_T_M__S_u_b_s_y_s_t_e_m_s Following is a description of
the IRIS ATM subsystems:
_a_t_m._s_w._e_o_e IRIS ATM software: driver,
utilities, and miscellaneous
files.
_a_t_m._s_w._d_e_v Files required for developing
upper-layer applications with
the IRIS ATM API.
_a_t_m._s_w._i_l_m_i IRIS ATM ILMI software:
_a_t_m_i_l_m_i_d daemon.
_a_t_m._s_w._s_i_g_d IRIS ATM Signalling software,
including the _a_t_m_s_i_g_d daemon.
_a_t_m._m_a_n._e_o_e Manual pages for IRIS ATM
utilities. There are man pages
for atm(7M), if_atm(7M),
if_atmarp(7M), atmarp(1M),
atmconfig(1M), atmilmid(1M),
atmsigd(1M), atmstat(1M),
atmtest(1M), ifatmconfig(1M),
sigtest(1M), spansd(1M).
_a_t_m._m_a_n._r_e_l_n_o_t_e_s These release notes.
_a_t_m._b_o_o_k_s Online documents that are
viewable with InSight.
2.1.3 _I_R_I_S__A_T_M__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s This
section lists the IRIS ATM subsystems and their sizes. All
subsystems are installed when you use the install atm and go
commands of _i_n_s_t.
Note: The listed subsystem sizes are approximate. Refer to
the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
on determining exact sizes.
Subsystem Name Subsystem Size
- 3 -
(1024-byte blocks)
_a_t_m._s_w._e_o_e 532
_a_t_m._s_w._d_e_v 68
_a_t_m._s_w._i_l_m_i 372
_a_t_m._s_w._s_i_g_d 2312
_a_t_m._m_a_n._e_o_e 76
_a_t_m._m_a_n._r_e_l_n_o_t_e_s 28
_a_t_m._b_o_o_k_s 1960
2.1.4 _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d IRIS ATM does not include a
release of IRIX (the operating system), so the operating
system must already be installed. IRIS ATM can be installed
without using the miniroot.
Note: After installation, the IRIS ATM driver will not
function until four additional steps are completed:
(1) the IRIS ATM software is configured, (2) the
board is installed, (3) the operating system is
rebuilt, by restarting the system or using the
_a_u_t_o_c_o_n_f_i_g command, and (4) the system is rebooted.
2.1.5 _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s The files listed below are used
by IRIS ATM software. Some of these files must be edited
during initial installation and configuration; editing of
others is optional and may be done at any time for
customization of the environment. See the "_I_R_I_S _A_T_M
_C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e" for complete details.
2.1.5.1 _O_r_i_g_i_n_/_O_n_y_x_2
/_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_q_u_a_d_o_c_3:
File for configuring the character device interface.
/_v_a_r/_s_y_s_g_e_n/_s_y_s_t_e_m/_q_u_a_d_o_c_3._s_m:
Instructions to _a_u_t_o_c_o_n_f_i_g when it is building the IRIS ATM
driver into the operating system.
2.1.5.2 _C_H_A_L_L_E_N_G_E_/_O_n_y_x
/_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_a_t_m:
File for configuring the character device interface.
/_v_a_r/_s_y_s_g_e_n/_s_y_s_t_e_m/_a_t_m._s_m:
Instructions to _a_u_t_o_c_o_n_f_i_g when it is building the IRIS ATM
driver into the operating system.
- 4 -
2.1.5.3 _G_e_n_e_r_i_c
/_v_a_r/_a_t_m/_a_t_m_h_w._c_o_n_f:
File for configuring the IRIS ATM hardware.
/_v_a_r/_a_t_m/_a_t_m_i_l_m_i_d._c_o_n_f:
File for configuring the IRIS ATM ILMI software.
/_e_t_c/_c_o_n_f_i_g/_a_t_m_i_l_m_i_d._o_p_t_i_o_n_s:
File for setting optional runtime modes for the ILMI daemon.
/_v_a_r/_a_t_m/_a_t_m_s_i_g_d._t_c_l:
File for configuring the IRIS ATM Signalling software.
/_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_i_f__a_t_m:
File for configuring the IP support in the IRIS ATM driver.
This file can be edited to enable/disable a number of _i_f__a_t_m
driver features.
/_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_i_f__a_t_m_a_r_p:
File for configuring SPANS support in the IRIS ATM driver.
This file can be edited to change _i_f__a_t_m_a_r_p driver features.
/_v_a_r/_a_t_m/_i_f_a_t_m._c_o_n_f:
File for configuring address resolution server for each
logical IP subnetwork.
/_v_a_r/_a_t_m/_p_v_c._c_o_n_f:
File for mapping IP addresses to VC addresses for PVCs.
/_v_a_r/_a_t_m/_s_p_a_n_s_d._c_o_n_f:
File for specifying spand options (Origin and Onyx2 only).
2.1.6 _F_i_l_e_s__T_h_a_t__A_r_e__I_n_s_t_a_l_l_e_d__B_u_t__D_o__N_o_t__N_e_e_d__T_o__B_e__E_d_i_t_e_d
The files listed below are installed as part of IRIS ATM,
however, they do not need to be edited at any time. These
files are required for proper operation of IRIS ATM.
/_e_t_c/_i_n_i_t._d/_a_t_m:
Script that configures and starts each ATM port and the _a_t_m#
IP logical network interfaces. The script also starts the
signalling and ILMI software. This script is called (via a
link, S28atm) from within the standard /_e_t_c/_r_c_2 multi-user
startup script. This file should not be edited.
/_e_t_c/_i_n_i_t._d/_n_e_t_w_o_r_k._a_t_m:
Script that initializes IP-over-PVC connections and address
resolution table. This script is called from within the
standard /_e_t_c/_i_n_i_t._d/_n_e_t_w_o_r_k multi-user network startup
- 5 -
script. This file should not be edited.
/_u_s_r/_l_i_b/_n_e_t_v_i_s/_m_i_b_s/_a_t_m_f__i_l_m_i._m_i_b:
ATM MIB definition file. This file should not be edited.
2.2 _I_n_s_t_a_l_l_i_n_g__I_R_I_S__A_T_M__S_o_f_t_w_a_r_e
This section describes how to install IRIS ATM software.
Before starting the installation, use the command below to
verify that IRIS ATM 2.1 (Origin) or ATM 1.0 (CHALLENGE) or
earlier is not installed.
% versions atm
If the display indicates that IRIS ATM 2.1(Origin) or ATM 1.0 (CHALLENGE)
or earlier is installed,
use the command below to remove the software:
# versions remove atm
Caution: Failure to remove IRIS ATM 2.1 or earlier may
destroy the MAC address on your IRIS ATM network
controller (hardware).
Otherwise, follow the instructions below to install IRIS
ATM.
2.2.1 _P_r_e_r_e_q_u_i_s_i_t_e_s Your system must be running IRIX
release 6.5. To verify the release your system is currently
running, use the command below:
% versions eoe
I eoe _d_a_t_e Execution Only Environment 6.5
2.2.2 _P_r_e_p_a_r_i_n_g__f_o_r__I_n_s_t_a_l_l_a_t_i_o_n
1. Use the "live" (non-miniroot) installation method, as
explained in chapter 4 of the ``_S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n
_A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.''
There are four sources possible for installing the
IRIS ATM software: from a local peripheral device,
from a remote peripheral device, from a remote
Ethernet boot server (distribution directory), from a
local distribution directory. These methods are
- 6 -
summarized and explained in Chapter 4 of the _I_R_I_S
_S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e, where Table 4-1 provides
an excellent overview.
Notes: ``Local'' refers to connecting the CD-ROM (or
tape) player directly to the target system (the
system onto which you are installing software).
``Remote'' refers to loading the software over
the target system's Ethernet network connection
using a CD-ROM (or tape) device connected to a
different Ethernet station.
In order to install software from a remote
distribution directory, your system must be
physically connected to the Ethernet and it
must have a functioning Ethernet connection.
2. Locate the following items:
- For installation from a peripheral device, locate
the CD-ROM disk containing IRIS ATM software. If
you specially ordered another medium (for
example, tape), locate that item.
- For installation from a peripheral device, locate
a device to play (read) the CD-ROM or tape. This
device is not shipped with the IRIS ATM product;
it belongs to your site.
- For installation from a distribution directory,
determine the host name of the Ethernet station
and the path to the directory.
3. Set up the installation hardware.
- If you are using a local device, follow the
instructions in your system's owner's guide to
connect the peripheral device.
- If you are using a remote device, follow the
remote workstation or server's instructions for
attaching peripheral devices.
- For installation from a distribution directory,
verify that the IRIS ATM software has been loaded
onto the station. A section of the _S_o_f_t_w_a_r_e
_I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e provides
instructions on preparing distribution
directories.
- 7 -
2.2.3 _I_n_s_t_a_l_l_i_n_g__t_h_e__S_o_f_t_w_a_r_e Use the live installation
method to install the IRIS ATM software (atm). To install
the default subsystems, use the "_i_n_s_t_a_l_l _a_t_m" and "_g_o"
commands once you have invoked _i_n_s_t. Step-by-step
instructions are provided in Chapter 4 of the _S_o_f_t_w_a_r_e
_I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.
If you are not sure how to use _i_n_s_t, Chapter 5 in the
_S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e provides
details.
When you have finished installing the new software, follow
the steps in the _I_R_I_S _A_T_M _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e to configure
the IRIS ATM subsystem.
2.3 _C_o_n_f_i_g_u_r_i_n_g__a__D_i_s_k_l_e_s_s__S_t_a_t_i_o_n
A diskless IRIS ATM station must be configured in accord
with the guidelines in this section.
1. The station must have either two network interfaces
(an Ethernet from which to boot and the ATM) or a
local CD-ROM player from which to boot and an ATM
interface. The remaining text and guidelines apply
only to stations that boot over an Ethernet.
A diskless workstation (client) must boot (from its
server) over its primary Ethernet connection, hence,
the diskless ATM station must have both Ethernet and
ATM connections. Use the command below to display the
station's network interfaces, then verify that one of
the IP addresses in the display is for the Ethernet
local area network attached to the _e_t_0 interface:
% /usr/etc/netstat -in
2. The _n_e_t_a_d_d_r value in NVRAM must be an Ethernet IP
address.
The station's PROM must use the Ethernet connection
for booting over the network. To verify that the
system's PROM can access the Ethernet network, use the
commands below. The values for _n_e_t_a_d_d_r and _i_n_e_t must
match.
% /etc/nvram netaddr
_x_x_x._x_x_x._x_x_x._x_x_x
% /_u_s_r/_e_t_c/_i_f_c_o_n_f_i_g _e_t_0
. . .
_i_n_e_t _x_x_x._x_x_x._x_x_x._x_x_x . . .
3. Ethernet must be configured as the primary network
interface.
- 8 -
Once the PROM has loaded the miniroot (bootstrap
kernel) from the boot server, control is passed to the
miniroot. At this point, the diskless client is known
to the boot server by the IP address in the NVRAM. If
this address were to change at this point, the server
would become confused and the boot process would not
complete. The best and easiest way to prevent this
from happening is to configure Ethernet (and build the
miniroot with Ethernet) as the primary network
interface.
To verify that Ethernet is configured as the primary
network interface and ATM is another, use the commands
below:
# /bin/grep if1name /etc/config/netif.options
<the display should be if1name=et0 or : if1name= >
# /bin/grep atm /etc/config/netif.options
<the display should be if#name=atm##>
The next kernel build (for example, _a_u_t_o_c_o_n_f_i_g) will
create an operating system in which Ethernet is the
primary interface.
Note: Once the miniroot is in control, the booting
procedure is completed using NFSr over the network
interface that the station's route daemon indicates
is the shortest path to the boot server.